home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / dorpch37.arc / SYSOP.DOC < prev   
Text File  |  1991-01-01  |  12KB  |  257 lines
  1.  
  2.  
  3.  
  4.                 DOORPCH v3.7 DOOR Operational Information for SysOps
  5.  
  6.                                  January 1, 1991
  7.                                         By
  8.                                  Raymond Clements
  9.                                  2204 Carriage Dr.
  10.                              Owensboro, KY  42301-5823
  11.  
  12.                              (C) Copyright 1987-1991
  13.                                All Rights Reserved
  14.  
  15.                                  The Pegasus BBS
  16.                              Node #1 - (502)684-9855
  17.                              Node #2 - (502)684-9871 HST
  18.                            RIME PCRelay routable ->PEGASUS
  19.  
  20.  
  21.                                   SysOp Operation
  22.                                  -----------------
  23.  
  24.          Please include the following information with any DOOR you write
  25.          which uses DOORPCH v3.7.  The SysOp will require the information.
  26.  
  27.  
  28.                                       Preface
  29.                                      ---------
  30.  
  31.          This is NOT meant to tell you how to setup DOORs on your BBS,
  32.          just how to setup DORPCH37 doors.
  33.  
  34.  
  35.                                  Support Shareware
  36.                                 -------------------
  37.  
  38.          Thank you for obtaining this door program.  Many hours of coding
  39.          have gone into its development.  Like all shareware products,
  40.          you're encouraged to register this program if it meets your needs.
  41.          Supporting Shareware helps insure the future development of such
  42.          programs and will entitle you to support from their authors.
  43.  
  44.  
  45.                                Environment Variables
  46.                               -----------------------
  47.  
  48.          Two environment variables must be set in your AUTOEXEC.BAT file:
  49.  
  50.          SET LIB=<drive:><path to DORPCH37.EXE>  Note: ONLY the PATH!
  51.  
  52.          Example:  SET LIB=C:\MYLIB
  53.  
  54.          The DORPCH37.EXE run-time library must then be placed in this
  55.          directory.  I'd suggest a separate directory as I do on my system.
  56.  
  57.  
  58.          SET DOORPCH=PCB     This variable is required by prior versions
  59.                              of DOORPCH, but not by DORPCH37.EXE.
  60.  
  61.          For your convenience DOORPCH v3.7 also supports the following three
  62.          new variables:
  63.                         %NODE% , %DRIVE% , and %DIRECTORY%
  64.  
  65.                         SET NODE=1          (ie. 1 , 2 , etc.)
  66.                         SET DRIVE=C:        (ie. C: , D: , etc.)
  67.                         SET DIRECTORY=\BBS\ (ie. \PCB\ , \BBS\ , etc.)
  68.  
  69.          These may be used to allow a single DOORNAME.CFG file for all nodes.
  70.          When using these variables please remember the combination of them
  71.          MUST form a valid DOS "drive:\path\" pointing to the location of the
  72.          BBS interface file.
  73.  
  74.  
  75.                                     DOOR Setup
  76.                                    ------------
  77.  
  78.          Make a batch file to run the DOOR as described in your BBS
  79.          documentation.
  80.  
  81.  
  82.                              Example DOOR batch file:
  83.                             --------------------------
  84.  
  85.          CD\DOORS\4CARD
  86.          4CARD 4CARD.CFG             <== Runs 4CARD.EXE passing
  87.                                          a parameter of 4CARD.CFG to it.
  88.          CD\BBS
  89.          BOARD
  90.  
  91.  
  92.                             Example DOORNAME.CFG file:
  93.                            ----------------------------
  94.  
  95.          It is highly recommended that none of the characters to the left
  96.          of the period in DOORNAME.CFG be changed.  If you want to have
  97.          different DOORNAME.CFG files for each node then I would recommend
  98.          changing the characters to the right of the period instead.
  99.          (ie. 4CARD.CF1)  You may also use the environmental variables to
  100.          only require one DOORNAME.CFG file for multiple nodes.
  101.  
  102.          C:\BBS\DOOR.SYS             <== The drive:\path\filename
  103.                                          of your BBS interface file
  104.                                          which is the same as
  105.  
  106.                                          %DRIVE%%DIRECTORY%DOOR.SYS
  107.  
  108.                                          using the above variables.
  109.          The Pegasus BBS             <== The name of your BBS.
  110.          Raymond                     <== The SysOp's FIRST name.
  111.          Clements                    <== The SysOp's LAST name.
  112.          John Doe & Jane Doe         <== The name(s) of the DOOR's sponsors,
  113.                                          if DOOR SECURITY SYSTEM is used.
  114.  
  115.  
  116.                             Command-line parameters
  117.                            -------------------------
  118.  
  119.          This parameter may be used when starting a DOORPCH v3.7 DOOR.
  120.  
  121.          /LOCAL                      <== Allows local usage of the DOOR as
  122.                                          the SysOp.
  123.                                          (ie. 4CARD 4CARD.CFG /LOCAL)
  124.  
  125.  
  126.                            DoorPch v3.7 Utility: DP37Util
  127.                           --------------------------------
  128.  
  129.          These parameters may be used with DP37Util to setup and maintain
  130.          each DOOR's high score file and/or challenge ladder file.
  131.  
  132.          /CREATE                     <== Creates the high score file and/or
  133.                                          the challenge ladder file.
  134.                                          (ie. DP37UTIL 4CARD.SCR /CREATE)
  135.          /PURGE:##                   <== Purge names from database if they
  136.                                          haven't used the DOOR in ## days.
  137.                                          (ie. DP37UTIL 4CARD.SCR /PURGE:21)
  138.  
  139.  
  140.                                  DOORNAME.SYS
  141.                                 --------------
  142.  
  143.          If the DOOR uses DoorPch's internal DOOR SECURITY SYSTEM then
  144.          upon registering the DOOR you should receive a DOORNAME.SYS from
  145.          the author.  (ie. 4CARD.SYS)  This file should be put in the
  146.          DOOR's default directory.
  147.  
  148.  
  149.                                    Libraries
  150.                                   -----------
  151.  
  152.          All DOORPCH v3.7 DOORs require the DORPCH37.EXE run-time library
  153.          and the Microsoft (R) QuickBASIC 3.0 run-time library, BRUN30.EXE,
  154.          be in your path.  Your DOOR program may have come with these files
  155.          in the archive file.  If they are not present, this DOOR program
  156.          WILL NOT RUN.  You should contact the DOOR author if the files
  157.          are missing.  You require one and only one version of these two
  158.          libraries for ALL DOORPCH v3.7 DOORware.  The files are also
  159.          available in DORPCH37.ZIP available on most of the better Bulletin
  160.          Board Systems.  If you wish a fully detailed explanation of how
  161.          DOORPCH operates with DOORS, then you may read the documentation
  162.          within the DORPCH37.ZIP file within which this documentation may
  163.          be found.
  164.  
  165.  
  166.                                   DOOR Operation
  167.                                  ----------------
  168.  
  169.          When this DOOR is in operation you have complete control over the
  170.          caller.  This DOOR was written using DOORPCH v3.7.  The logic is
  171.          safe and every precaution has been taken to insure this code works
  172.          flawlessly.  If it doesn't, please let us know.  Many
  173.          function/operational keys are at your disposal:
  174.  
  175.          F1    -   Displays the version of DOORPCH compiled and linked
  176.                    into the DOOR.
  177.          F2    -   Displays a caller's Alias if one is used via the DOOR.
  178.          F3    -   Toggles Local Music ON/OFF.
  179.          F4    -   Toggles the Bell ON/OFF.
  180.                    Value is returned to BBS when DOOR completes.
  181.          F5    -   DOS Shell.  Allows the SysOp to exit to DOS from inside
  182.                    a DOOR.
  183.          F6    -   Toggles the Graphics mode of the caller ON/OFF.
  184.                    Value is returned to BBS when DOOR completes.
  185.          F7    -   Toggle the caller alarm ON/OFF.
  186.                    Value is returned to BBS when DOOR completes.
  187.          F8    -   Returns the caller involuntarily to the BBS.
  188.          F9    -   Toggles the display ON/OFF.
  189.                    Value is returned to BBS when DOOR completes.  Some doors
  190.                    may force the display ON, but the original OFF value will
  191.                    be returned to the BBS if this occurs.
  192.          F10   -   Activates SysOp/Caller CHAT mode within the DOOR.
  193.          ESC   -   Deactivates CHAT mode.  DOOR is resumed.
  194.          ALT-H -   HELP key for lines 24/25 capabilities.
  195.          UP    -   Allows the SysOp to add additional time for the caller.
  196.                    Value is returned to BBS when DOOR completes.
  197.          DN    -   Allows the SysOp to subtract time from the caller.
  198.                    Value is returned to BBS when DOOR completes.
  199.          ALT-N -   Some BBSs use SysOp next on control/indicator.
  200.                    Value is returned to BBS when DOOR completes.
  201.          ALT-X -   Some BBSs will exit after current caller completes their
  202.                    session.  Value is returned to BBS when DOOR completes.
  203.  
  204.  
  205.                              Example: DEVICE=ANSI.SYS
  206.                             --------------------------
  207.  
  208.          DOORPCH uses this device driver for displaying all colors and
  209.          screen positioning to the local console.  Color Graphics will
  210.          always be sent to the local console if you are using a color
  211.          monitor.  If a caller is in non-graphics mode you will still see
  212.          colors if you have a color monitor.  The reverse is also true.
  213.          If the caller is in graphics mode and the local console is a mono
  214.          monitor then colors will NOT be displayed to the local console.
  215.  
  216.  
  217.                                        MUSIC
  218.                                       -------
  219.  
  220.          This DOOR program may utilize ANSI music.  If it does, and you
  221.          are running in a NETWORK, DOORPCH does not send ANSI music to the
  222.          local console unless you have it configured to.  We have found that
  223.          under some Multi-Tasking operating systems such as DoubleDOS that
  224.          the "partition" locks up until the music completes.  If you are on
  225.          a single node system (not in a network), then music will be played
  226.          to the local screen if the local screen is active (F9 ON) and you
  227.          have DOORPCH configured that way or local music is toggled on (F3 ON).
  228.  
  229.  
  230.                                        BELL
  231.                                       ------
  232.  
  233.          DOORPCH logic will not allow a BELL to be sent to the local
  234.          console when the local screen is inactive (F9 OFF) or the caller
  235.          alarm is toggled off (F7 OFF).  This, of course, assumes the
  236.          DOOR author follows the DOORPCH rules.
  237.  
  238.  
  239.                                       ERRORS
  240.                                      --------
  241.  
  242.          All errors should recover and cause the DOOR program to exit
  243.          gracefully and return to the main system.  All errors are logged
  244.          in the "DOORPCH.ERR" file found in the "SET LIB=" directory.  The
  245.          error number and line number are included with the date and time.
  246.          Errors will be either caused by the main module (the authors code,
  247.          contact him/her) or the DOORPCH sub (contact Raymond Clements).
  248.          It should NEVER cause the BBS to hang.  If your BBS hangs, you are
  249.          requested to contact the appropriate party and report the error and
  250.          circumstances that caused it.  Because we are using Microsoft's (c)
  251.          QuickBASIC 3.0 run-time routines, it is possible that BASIC will
  252.          detect a fatal error condition.  As mentioned above, we have taken
  253.          every precaution, but simply cannot code for every error condition.
  254.          If the DOOR author follows all the rules, the DOOR should run without
  255.          error.
  256.  
  257.